Elixirでコマンドラインアプリケーションを作る

#Elixir

かんあきひで

2016.10.17

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

プログラマーは普段の仕事を簡単にするために、各々便利なスクリプトを作り活用しています。
使用するプログラミング言語はどれでも良いのですが、簡単に書けて楽にCLIアプリケーションとしてビルド、リリースできる仕組みがあるとありがたいです。
ElixirにはCLIアプリケーションを簡単に作成できる escript というツールが用意されています。
今回はElixirでCLIアプリケーションを作成してみます(検証したelixirのversionは1.3.2です)。

環境構築は以下のページを参照してください。
MacにElixir開発環境を構築する

プロジェクト作成

ますコマンドラインアプリケーションのプロジェクトを作成しましょう。

mix new cli_demo

escript

escriptはElixirのアプリケーションをCLIアプリケーションとしてコンパイルする仕組みです。
これを使うには、mix.exsファイルに以下の行を追加します。

    def project do
      [app: :cli_demo,
       escript: [main_module: CliDemo.CLI], # この行を追加します
       version: "0.0.1",
       elixir: "~> 1.3",
       build_embedded: Mix.env == :prod,
       start_permanent: Mix.env == :prod,
       deps: deps()]
    end

エントリポイントの作成

CLIアプリケーションのエントリポイントとなるモジュールを作成します

projectroot/lib/cli_demo/cli.ex

  
defmodule CliDemo.CLI do
  # ここがCLIアプリケーションのエンドポイント
  def main(argv) do
    parse_args(argv)
    |> process
  end
     
  # 引数をパースする処理
  def parse_args(argv) do
    parse = OptionParser.parse(argv,
                               switches: [ help: :boolean], # boolean型に変換する
                               aliases: [h: :help]) # :helpに変換する

    case parse do
     
      { [ help: true ], _, _}
        -> :help
    
      { _, message, _}
        -> message
     
      _ -> :help
    end
  end

  def process(:help) do
    IO.puts """
    usage: cli_demo <message>
    """
    System.halt(0)
  end   
    
  def process(message) do
    IO.puts message
  end
end

コマンドライン引数のパース処理には OptionParserライブラリを使用しています。
本題とずれるので説明は省略しますが、-hを引数には渡すと:helpに変換され、文字列がbooleanに変換されます

アプリケーションのビルド、インストール

ビルドしてCLIアプリケーションを作成します。作成したバイナリはホームディクトリの下の.mix/escriptsに保存されるので、環境変数PATHに追加しておく必要があります。

環境変数の設定

私はZSHを使っているので.zshrcに設定しました。書き込むファイルは使っているシェルによって変えてください。

export PATH="$HOME/.mix/escripts:$PATH"

ビルド、インストール

$ mix do escript.build, escript.install
Generated escript cli_demo with MIX_ENV=dev
Are you sure you want to install escript "cli_demo"? [Yn] y
* creating /Users/username/.mix/escripts/cli_demo

実行

早速、実行してみましょう

$ cli_demo "Elixir Rocks"
Elixir Rocks

ヘルプメッセージも実装通りに表示されます

$ cli_demo -h
usage: cli_demo <message>

まとめ

簡単にコマンドラインアプリケーションを作る環境が用意されているのは非常にありがたいです。
が、できればhex.pm(パッケージマネージャー, RubeGemsのElixir版)やGitHubからコマンド一発でインストールしたいものです。
現在開発版のバージョン1.4ではまさにこれらの機能が実現される予定です
mixの公式ドキュメント

GitHubからのインストール